home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / dirwork1.62 / dw.doc < prev    next >
Text File  |  1995-03-27  |  42KB  |  974 lines

  1.  
  2.     DirWork V1.62 - Chris Hames 12th June 92.  All rights Reserved.
  3.     ---------------------------------------------------------------
  4.             DW Size 70968 bytes
  5.  
  6.     Need to get around your directories fast and simply.  Force yourself
  7. to read fully this doc file and I think you will find this program of great
  8. use.  What makes DirWork better than the rest ?
  9.  
  10.     VERY Configurable.  Buttons/Button-keys/Options/Screen Mode/
  11.     Screen Colors/Window Size/Window Position/PopKeys/Tools etc can be
  12.     modified and the DW executable modified to have these values.
  13.     External configuration editor program to make changes easier.
  14.  
  15.     Detaches.  So when you type DW from Shell/CLI you can still use your
  16.     Shell/CLI as if nothing happened.  No need to Run!  Paths are kept!
  17.  
  18.     Sleep. Can be put to sleep so it disappears completely until you
  19.     select it from the workbench tools menu (kick2.0-) or press left
  20.     Ctrl-Shift-Alt-D or whatever keys you configured it to.
  21.     Also can be started in sleep mode so "DW -s" in your
  22.     startup-sequence will have it there for when you want it later.
  23.     You can also place DW in your WBStartUp drawer and add the ToolTypes
  24.     SLEEP & DONOTWAIT.
  25.  
  26.     Intelligent.  Double click the left mouse button on the filename of
  27.     a IFF picture and it will be automatically displayed.  Double click
  28.     a text file to display it, press the right mouse button to edit it!
  29.     Double Click a .lzh file and you see the contents, right mouse
  30.     button on one extracts the contents to the destination dir and then
  31.     reads in the new entries.  If you have a middle button then pressing
  32.     it on the .lzh will extract the files in the background so you can
  33.     continue doing other things.
  34.     As well as many other instant actions on different types of files
  35.     and the instant types are configurable.
  36.  
  37.     The inbuilt text viewer, picture viewer and disk functions
  38.     run as separate processes on separate screen so you can double
  39.     click a text file and then continue working with DW then swap
  40.     the screen and the text viewer is still there.  Your diskcopy
  41.     can be going on one screen while you a copying files with DW as
  42.     normal.
  43.  
  44.     A show built in that loads in the next picture while your looking
  45.     at the last.  Does icons, SHAM and some DHIRES pictures.  You can
  46.     of course set up a button to use your own show utility.
  47.  
  48.     Buffered directories.  Press the right mouse button over the dir
  49.     text gadget and you get a menu of previous directories which you
  50.     can instantly go to.  Parent buttons that will use the buffered
  51.     dir when appropriate to save you heaps of dir loading time.
  52.  
  53.     A completely mouse controlled type/hxtype which will automatically
  54.     decrunch powerpacker crunched text files.
  55.  
  56.     Both memory and BootBlock virus checking.
  57.  
  58.     Inbuilt Diskcopy/Format/Install with multiple destinations etc.
  59.  
  60.     PopKeys.  Define keys to start up programs. eg make Amiga-P start
  61.     your paint program.  Amiga-Escape start a NewShell etc etc etc
  62.     Also adds these programs to DW's menu and your workbench Tools menu
  63.     if using Kick2.0-.
  64.  
  65.     ScreenBlanker so that the phosphors on your monitor get a rest.
  66.     AutoPoint option so that the window the mouse is over is selected.
  67.     MouseAccelerator with selectable threshold.
  68.  
  69.     Copy & move cloning so that the date/protection/filenote is same.
  70.  
  71.     Fast and Smooth Floppy Dirs!  Getting a directory off a floppy
  72.     is up to 2 times faster.  And your drive doesn't grind back and
  73.     forward anywhere near as much as normal.
  74.  
  75.     Size.  At less than 70K uncompressed it makes mince meat of most
  76.     of those huge memory hungry utilities.
  77.  
  78.  
  79. This program is SHAREWARE so please support the work that has gone into it.
  80. To minimize bank charges please try to contribute with one of the following:-
  81.     Australian Cash or Cheque.
  82.     Any cheque drawn on a Australian Bank.
  83.     Foreign Cash (US, English or German preferred).
  84.     International Money Order or Bank Cheque.
  85. The suggested contribution of $35 makes you a registered user.  This allows
  86. you to get direct support from me as well as access to updates.  You also a
  87. disk containing the next major version (when it is available) of this program
  88. sent to you.
  89. Please send the contribution & any ideas etc to:-
  90.     C Hames           |Internet:
  91. Snail:    6 Pamela Crt      |   bytey@phoenix.pub.uu.oz.au
  92.     Blackburn South   |   bytey@phoenix.apana.org.au
  93.     VIC 3130          |FidoNet BBS:
  94.     Australia         |   3:633/353
  95. And don't forget to include the version number you have!
  96.  
  97. This program may be copied as long as it is accompanied by this doc file
  98. both unaltered & no money is charged(except for a reasonable copying fee
  99. such as what Fred Fish charges).  All use of this program is at your own
  100. risk & I assume no responsibility or liability for any problems that occur.
  101.  
  102. Future Improvements:- (When registering please tell me which ones you want)
  103.     More configurable. ie Screens/ButtonPositions/Colors/Priority etc
  104.     copy/move not going to fit requester
  105.     Sort by date and size.
  106.     Text viewer handle ANSI better(& 8 color option).
  107.     BootBlock brain file.
  108.     Play Stereo sound samples.
  109.     PointerBlanker.
  110.     print separate process.
  111.     Window to front by double clicking.
  112.     Recorded keystrokes.
  113.     Auto load of directory on startup. DW dh0:
  114.     Copy/delete/move option to copy .infos as well
  115.     copy,delete,move want to quit, try again unprotected, continue.
  116.     Faster(the need for speed!).
  117.  
  118. NOTE:
  119.  **************************************************************************
  120. * Updates don't magically appear.  So support the product by contributing. *
  121. * If there aren't many contributing in the future no updates, crippleware  *
  122. * or similar will be what happens.                                         *
  123.  **************************************************************************
  124.  
  125.  
  126.  
  127. History:-
  128.     27/ 1/90 1.00    First Release.
  129.      5/ 2/90 1.01    VMK updated to v27.  Stopped title bar flashing.
  130.     12/ 2/90 1.02    Icon. Faster. Smaller. Now uses less memory(5K) if
  131.             destination display is not used.
  132.     15/ 2/90 1.03    Detaches from CLI.  Some Workbench problems fixed.
  133.             A Show bug fixed.
  134.     22/ 2/90 1.04    CD bug fixed.  Volumes button added.  Dir buttons
  135.             and options can be modified and saved.  VMK can
  136.             now automatically be executed every 10 secs.
  137.     14/ 7/90 1.10    Heaps of little improvements. Copy/Delete/Move Dirs.
  138.             Now VERY configurable buttons. Sleep. Window sizing.
  139.             HxType/Type/Search Esc works anytime now. Rename/
  140.             makdir/copy/move/delete add or remove from both
  141.             filelists where appropriate.  So many more changes
  142.             that I am calling it 1.10 !
  143.     30/ 7/90 1.11    Bug fixed when getting dirs with spaces in them.
  144.     17/ 8/90 1.12    Rare problem getting dirs with spaces at end.
  145.     10/ 1/91 1.20    More than 255 files displayed.
  146.             Dirs above files option added.
  147.             And too many other things to mention.
  148.     13/ 1/91 1.21    Sometimes crashed when started from cli,
  149.             bug found in detach routine. Argh!!
  150.             Display .info files option added.
  151.             Window Pos now saved with config.
  152.     16/ 1/91 1.22    Recognition of text files improved. Other little
  153.             things improved.
  154.     10/ 6/91 1.30    Wouldn't save config if started in sleep mode (-s)
  155.             fixed.  Didn't open some windows at same offset as
  156.             window fixed.  Now gets the dirs after sleep.
  157.             Automatically gets info(bytes free) for dirs after
  158.             a copy move or delete. MakeDir can have icon.
  159.             Bootblock checking.  Popkeys.  ScreenBlanking.
  160.             Runs programs with spaces(Dave!).
  161.             Save's path of DW program with save executable.
  162.             Paths other than C: recognized(Thanks Randell).
  163.             Parent/root far left or right of the text gadget
  164.             right mouse button over text gadget gets dir.
  165.             Shells etc now have close gadgets if kick 2.0,
  166.             and the N,x,u commands have been improved.
  167.             Kick 2.0 looks. Heaps of other little things.
  168.     22/ 6/91 1.31    Requester kick 1.2/1.3 freeze bug hopefully gone.
  169.             Crash after RMB instant getdir gone.
  170.             AutoPoint for James.  Screen option.
  171.             Copy/move clone code better and kick 1.2/1.3 date.
  172.             Filenote problem with FSDirs problem fixed.
  173.             Better FileSelection. Requester bigger.
  174.             FileBits/Note writing under Kick 1.2/1.3 fixed.
  175.             Resizing doesn't make slide gadgets go to top.
  176.             Kick 2.0- execute window title shows path.
  177.             Delete didn't request for non-empty dirs fixed.
  178.             Popkey stuff gets added to tools menu in Kick2.0-
  179.             No flashing bottom line.
  180.             And some other little things.
  181.     13/10/91 1.40    Middle mouse button instant actions added.
  182.             Button/Instant Config strings larger & key codes.
  183.             Popkey data larger & with full function defs.
  184.             PopKey/tools now are in DW menu as well now.
  185.             ScreenBlank bug removed. Volumes button improved.
  186.             Right parent/root allows for window width not 640.
  187.             Two characters are now used to show protection.
  188.             Uses paths when started from workbench.
  189.             PlaySS now uses rate in 8SVX files.
  190.             Inbuilt Diskcopy/Format/FormaQuick/Install added.
  191.             Wakeup now brings screen/window to front and
  192.             activates if it is already open.
  193.             Key to go to those letter entries for Michael.
  194.             Bug in IFF Show with strange width pictures fixed.
  195.             and some Overscan support added.
  196.             CAPSLOCK qualifier is now ignored for keys.
  197.             AutoPoint drag bug fixed.  MouseAcceleration added.
  198.             Buffered directories menu added.
  199.             Added option to allow only one DW to be in memory.
  200.     21/10/91 1.41    Qualifier with selected file filebits bug fixed.
  201.             FSDir bug fixed with trying to get a file.
  202.             Double Click file selection update fixed.
  203.     23/10/91 1.42    Swap only refreshed one of the text gadgets.
  204.             Double clicking a file that DW couldn't open bugfix.
  205.             Sleep could cause dir without files to be buffered.
  206.             A few other little things.
  207.     30/10/91 1.43    Fixed certain space filenames causing partial getdir.
  208.             Type would do partial read of powerp file if no lib.
  209.             Right mouse on little buttons sometimes did bufmenu.
  210.             DiskName & BytesFree wasn't shown until after getdir.
  211.             Added keyboard equiv for Type buttons.
  212.             Button colors/looks now more consistent.
  213.      2/ 2/92 1.50    Source and destination DiskOp selection fixed.
  214.             Awake didn't bring WB screen to front fixed.
  215.             FBits  size failed on file with rwed off in (k2.0).
  216.             Copy/move didn't delete partial files if error.
  217.             Copy can copy as
  218.             Functions N,u,a can CD source or destination dir.
  219.             Function x has become obsolete now use u.
  220.             Instant types now can be changed.
  221.             3 more instant types added.
  222.             Pattern select(K2.0-) added to func j and l obsolete.
  223.             Requester should now adjust for massive title.
  224.             Makdir adds drawer to list if appropriate.
  225.             Show does icons, SHAM and some DHIRES.
  226.             DW screen is public(K2.0-) so CON's can open on.
  227.             Function a now does spaces and adds "/*" to dirs.
  228.             Tools menu splits into 2 if too many tools for one.
  229.             Info function does Dir bytes as well.
  230.             Function w make icon added.
  231.             Function L relabel added.
  232.             keyQualCode conversion problems fixed.
  233.             RMB activates window option.
  234.             Parent using buffered dir option added.
  235.             Key activate for left/right text gad added.
  236.             Diskcopy to same drive without the ram crash fixed.
  237.             DiskOp src/des now stored in config.
  238.             DiskOp FFS formatting.
  239.             DiskOp,Show,Type are now run as separate processes!
  240.             Type new keys h,j,j,keypad8,keypad2,keypadhome,
  241.             CtrlUpcursor,keypadend,CtrlDowncursor,q,keypad5.
  242.             Type separate overscan(Kickstart2.0-) screen.
  243.             Type ANSI search and print.
  244.      4/ 2/92 1.51    Some show problems fixed.
  245.  
  246.      1/ 6/92 1.60    Many improvements to show including autoscroll,
  247.             fixed some problems with SHAM & DHIRES pics,
  248.             added keys to allow moving around bitmaps by
  249.             page and extremes, added keys to move the view
  250.             around, added key to toggle interlace.
  251.             Relabel was made 2.0 only as it should have been.
  252.             Will now try to use arp.library for date if 1.2/1.3.
  253.             Can be started in sleep mode with SLEEP tooltype.
  254.             Right/Middle mouse button actions use to work even
  255.             if DW window not visable but active!
  256.             Sorting filenames with numbers improved.
  257.             Filebits always set the read protect bit.
  258.             Made all console windows /AUTO under 2.0
  259.             Made s,d CD options refetch only if not capital.
  260.             Print could keep asking cancel!!!
  261.             Type/HxType would report not enough memory with
  262.             certain filesystems under Kickstart 2.0.
  263.             Type/HxType/Show would leave DW busy even if it was
  264.             displaying the last file to be displayed.
  265.             Type/HxType slider gadget under Kick1.2/1.3 would
  266.             sometimes not allow you to view start of file.
  267.             Type/HxType would only recognize right shift key.
  268.             Prompts wouldn't be displayed in certain situations.
  269.             File/Dir size would only display 7 characters.
  270.             Type/HxType/Show under Kickstart 2.0 would centre
  271.             the screen incorrectly for overscan screens.
  272.             Move/Copy/Delete various improvements.
  273.             Workbench library under Kickstart 2.0 only open
  274.             when needed.
  275.      2/ 6/92 1.61    DW was turning the sprites off.
  276.     12/ 6/92 1.62    Stack given to other programs could have been zero
  277.             under Kickstart 1.2/1.3 when DW started from WB.
  278.             Stack given to other programs is now inherited
  279.             if DW started from Shell/CLI.
  280.             Display of picture could busy wait on edges.
  281. ============================================================================
  282. MANUAL
  283.  
  284.     1. Instructions for the default DirWork
  285.     2. Options in DirWork & Options in DWEdit
  286.     3. Hints/tips
  287. ============================================================================
  288.  
  289. ----------------------------------------------------------------------------
  290.     1. Instructions for the default DirWork
  291. ----------------------------------------------------------------------------
  292.  
  293. The window display
  294.   +--------------------------------------------------------------------+
  295.   |+|  Title Bar - Chip & total memory available                   | | |
  296.   |--------------------------------------------------------------------|
  297.   |  +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++   |
  298.   |  +++ Buttons +++ +++ +++ +++ +++ Buttons +++ +++ +++ +++ +++ +++   |
  299.   |  +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++   |
  300.   /   Left Directory    Al No CD << <> >> CD No Al Right Directory     /
  301.   |--------------------------------------------------------------------|
  302.   | Left File List                | || |        Right File List        |
  303.   |                               |S||S|                               |
  304.   | DirectoryName         ??      |l||l| DirectoryName         ??      |
  305.   |    OR                         |i||i|    OR                         |
  306.   | FileName              ??  size|d||d| FileName              ??  size|
  307.   |                        ^      |e||e|                        ^      |
  308.   |         if undeletable u      | || |         if undeletable u      |
  309.   |        if has filenote f      |G||G|        if has filenote f      |
  310.   |           if is script s      |a||a|           if is script s      |
  311.   |                if pure p      |d||d|                if pure p      |
  312.   |                               |g||g|                               |
  313.   |                               |e||e|                               |
  314.   |                               |t||t|                               |
  315.   |                               | || |                               |
  316.   |--------------------------------------------------------------------|
  317.   |Errors and other messages     Disk Names & Bytes Free as well       |
  318.   +--------------------------------------------------------------------+
  319.  
  320. Actual directory text (Left Directory or Right Directory)
  321.  
  322.     Pressing the Right mouse button when over the text showing the path
  323.     of the dir brings up a menu of previous directories as well as a list
  324.     of volumes.  If you just let go over the text gadget it will read
  325.     that directory into the file list.
  326.     eg If DF0: was in the Left Directory text gadget you could insert
  327.        a new disk into the internal disk drive DF0: and then press the
  328.        right mouse button over the DF0: in the Left directory text to
  329.        read in the new directory.
  330.     If you move down onto one of the previous directory names and let go
  331.     it will be fetched from memory (it won't read the disk to get it)
  332.     since it is buffered from when you recently read that directory.  If
  333.     you let go on of the volumes (these are a list as if you pressed the
  334.     volumes button and are indented one to the right) it will be read in
  335.     from disk.
  336.  
  337.     Pressing the left mouse button over the far left/right of the text
  338.     gadget(see the "/" in window representation above) gets the parent.
  339.     Parent makes DF0:t/r become DF0:t
  340.     Right button gets the root. Root makes DF0:t/r become DF0:
  341.     If the Parent buf option is on (is by default) and the last directory
  342.     you read is the same as the new one the buffered copy of the dir is
  343.     used. ie if you get the dir "DF0:" then "DF0:??" then press parent
  344.     or root buttons "DF0:" will not be re-read from disk, the buffered
  345.     copy will be used instead.
  346.  
  347.     You can press the left mouse button over the left or right directory
  348.     text gadget then edit the directory to the one you want to work with
  349.     and then if you press return the directory will be read in.
  350.     These gadgets can be activated by the keys Del & Help for left &
  351.     right respectively (see DWEdit if you want to change these keys)
  352.     Remember in most string gadgets right Amiga X clears the text in
  353.     the gadget, and you can use shift -> or <- to go to end or start
  354.     of the text.
  355.  
  356.  
  357. FileList(s)
  358.  
  359.     Press the left mouse button to select/deselect a file or directory
  360.     name.
  361.  
  362.     Right mouse button or double click left button on a directory reads
  363.     in that directory.
  364.  
  365.     Left mouse button to the far left or right of a file/dir will
  366.     bring up a requester with information about the file/dir
  367.     the Filename, FileNote and Protection bits which you can edit.  As
  368.     well as the size and date(only if using kickstart 2.0- or you have
  369.     the arp.library).  If you select a file the title bar of this
  370.     information window will tell you what instant type DW would have
  371.     used if you had double clicked this file.  If this instant type is
  372.     ILBM (a IFF picture file) it will also tell you the
  373.     Width*Height*Depth.
  374.  
  375.     Use the slide gadget to see files that are not displayed.  You can
  376.     also put the mouse pointer over the file list and press the key of
  377.     the first letter of the filename you are interested in and the file
  378.     list will move to the files/dirs starting with that letter.
  379.  
  380.     Double Click of left Button on a file will try to recognize the file
  381.     and automatically do something with the file(eg With default settings
  382.     the quickly double clicking the left button on a text file will type
  383.     it & and double clicking on a IFF picture(such as a picture from a
  384.     paint program) file will show it with the internal show).
  385.  
  386.     Right Mouse Button on a file will try to recognize the file and
  387.     automatically do something with the file.
  388.     eg With default settings the Right mouse button on a text file will
  389.        edit it (If you have configured your instant edit to your editor
  390.        or it already is) or pressing the right mouse button on a picture
  391.        file will show it with Mostra(© Sebastino Vigna) if you have that
  392.        program.
  393.  
  394.     Middle Mouse button will also do another selectable action if you
  395.     have one on your mouse and have Kickstart 2.0-.
  396.  
  397. Here is a table of the default instant Operations:-
  398.  
  399.  
  400. File type    Double Clicking            Right Mouse button
  401. ----------------------------------------------------------------------------
  402. MOD.        Intuitracker filename        Run >NIL: Intuitracker file
  403. .ARC        Arc v filename            Arc xw filename
  404. .DMS        DMS Write filename        DMS Write filename
  405. .LZH        LZ l filename            LZ -m -x -r x filename
  406. .LHW        Lhwarp Write 0 filename        Lhwarp Write 0 filename
  407. .PAK        filename            filename
  408. .WRP        UnWarp filename            Run >NIL: UnWarp filename
  409. .ZIP        UnZIP -v filename        UnZIP -xdo filename
  410. .ZOO        Zoo v filename            Zoo xO// filename
  411. .GIF        VirtGIF filename        Run >NIL: VirtGIF filename
  412. .INFO        INTERNAL Show            Run >NIL: IconEdit filename
  413. 8SVX        INTERNAL PlaySS filename    PlaySS filename
  414. ANIM        ShowANIM filename        ShowANIM filename
  415. ILBM        INTERNAL Show filename        Mostra filename
  416. SMUS        PlaySMUS filename        PlaySMUS filename
  417. FTXT
  418. Most        Most filename            Run >NIL: Most filename
  419. PowPk        INTERNAL Type filename        PPShow filename
  420. Exect                        filename
  421. Text        INTERNAL Type filename        Run >NIL: E filename
  422. Binry        INTERNAL HxType filename    Run >NIL: NewZAP filename
  423. .LHA        LZ l filename            LZ -m -x -r x filename
  424. .UUE        INTERNAL Type filename        uudecode filename
  425. .JPG        Run >NIL: JView            Run >NIL: JView
  426.  
  427.  
  428. Buttons
  429.     The main idea is to press the left mouse button if you are referring
  430.     to the source as the file list below the pointer.  So to copy from
  431.     the left file list to the right list, click on the left copy
  432.     button.  And to copy from the right file list to the left file list,
  433.     click on the right copy button.
  434.  
  435.     You can also click on a button with the right mouse button to refer
  436.     to the opposite file list but if this sounds confusing just ignore
  437.     this paragraph.
  438.     (eg Left button on left DF0: will get the directory from DF0:
  439.     and put it in the left file list, but right button on left DF0: will
  440.     get the directory DF0: and put it in the right file list)
  441.  
  442.     Below is a description of what the buttons will do when the default
  443.     setup is used.  You can modify button functions to do something
  444.     completely different if you want.
  445.  
  446.     DF0: DF1: RAM: SYS: etc
  447.         Just press these to get the directory of this name in the
  448.         file list below the pointer.
  449.  
  450.     Sleep    Puts the task to sleep until you press the four left keys
  451.         Ctrl-Shift-Alt-D.  ie The window disappears as if you quit
  452.         but the program is still there waiting until you press the
  453.         keys.  So you don't have to load DirWork all the time.
  454.         DirWork starts in Sleep mode if you type DW -s instead of
  455.         the usual DW when you run it from Shell/CLI, or you add the
  456.         SLEEP & DONOTWAIT tool types to the DW icon and start it
  457.         from workbench.
  458.         So you can have the command DW -s in your startup-sequence
  459.         or DW in your WBStartup drawer then when you actually want
  460.         DirWork later you just have to press the keys
  461.         Ctrl-Shift-Alt-D or if running Kick2.0- just can select DW
  462.         in the Tools menu of workbench.
  463.         Do what you want then press the sleep button to make DirWork
  464.         disappear again.  See PopKeys information for how to change
  465.         the key combination that wakes DirWork up.
  466.  
  467.     Al    Select all files.  See DWEdit to make it select dirs as well.
  468.  
  469.     No    Unselect all files & dirs.  See DWEdit for other options.
  470.  
  471.     PatSe    Requests for a pattern to select matching file(s)/dirs(s).
  472.         This button only works if you are running Kickstart 2.0-.
  473.         You can toggle if you want Files, Dirs or both to be
  474.         selected.  Matching is same as AmigaDOS 2.0:-
  475.  
  476.         ?    Matches any character
  477.         #    Matches the following expression 0 or more times
  478.         (ab|cd)    Matches either item separated by the |.
  479.         ~    Nots the following expression.
  480.         [abc]    Matches any of the characters in the brackets.
  481.         [~ab]    Matches any of the characters not in the brackets.
  482.         %    Matches 0 characters.
  483.  
  484.         Examples:-
  485.  
  486.         ~(#?.info)  All files that don't end in .info.
  487.         #?.dat      All files ending in .dat.
  488.  
  489.  
  490.  
  491.     <>    Swaps the left and right file list displays.
  492.  
  493.     >> & <<    Copies one file list to the other file list.
  494.  
  495.     Info    Updates the info(bytes Free and name). And displays how many
  496.         dirs/files/bytes are selected.  Good to see if you are going
  497.         to be able to fit all the file(s)/dir(s) you want to copy.
  498.  
  499.     Copy    Copies files/dirs from one dir to another.
  500.         BytesFree for the source/destination is updated.
  501.         See the DWEdit documentation if you want it to clone
  502.         the original date/filenote/protection etc.
  503.  
  504.     CpyAs    Copies files/dirs from one dir to another.  Requests you
  505.         for the destination name.
  506.         BytesFree for the source/destination is updated.
  507.         See the DWEdit documentation if you want it to clone
  508.         the original date/filenote/protection etc.
  509.  
  510.  
  511.     Move    Moves files/dirs from one dir to another.
  512.         BytesFree for the source/destination is updated.
  513.         See the DWEdit documentation if you want it to clone
  514.         the original date/filenote/protection etc.
  515.         Please note the DOS 1.2/1.3 bug where you lose directories
  516.         if you move a directory to be a child of itself.  I
  517.         intercept and stop some but not all.
  518.         ie Move ONE ONE/ONE  !!!!IS NOT A GOOD IDEA!!!!
  519.  
  520.     Delet    Delete files/dirs.  You are prompted before non empty dirs
  521.         are deleted for confirmation but see the DWEdit documentation
  522.         section if you don't like this.
  523.         BytesFree for the directory is updated.
  524.  
  525.     Print    Copies selected files text to the printer.
  526.         See DWEdit for other options like Tabs to spaces.
  527.  
  528.     Renam    Rename files/dirs.  Edit names in the requester.
  529.         Please note the DOS 1.2/1.3 bug where you lose directories
  530.         if you move a directory to be a child of itself.  I
  531.         intercept and stop some but not all.
  532.         ie Rename ONE ONE/ONE  !!!!IS NOT A GOOD IDEA!!!!
  533.  
  534.     MakDi    Make a new directory. Enter name in requester.
  535.         See the configuration section if you want it to also create
  536.         a icon for the directory each time.
  537.  
  538.     Prote    Change delete protection of a file/dir.  Lets you toggle
  539.         the delete protection of a file.  A file with delete
  540.         protection on has a u next to the right of the filename.
  541.         See DWEdit for heaps of different configs for this.
  542.  
  543.     CD    Makes the dir the current directory.
  544.  
  545.     Type    Displays a text file to a screen (overscan if kick2.0-).
  546.         Use the slide gadget on right to quickly scan and use buttons
  547.         down below to move through the file or toggle between a hex
  548.         or ASCII display of the file.
  549.         Or use keyboard:-
  550.           Return or CursDown or KeyPad2 or j = NextLine.
  551.           CursUp or Keypad8 or k = PrevLine.
  552.           Space or Shift/CursDown or KeyPad3 = NextPage.
  553.           BackSpace or Shift/CursUp or KeyPad9 = PrevPage.
  554.           Keypad7 or Ctrl/CursUp = Start of file
  555.           Keypad1 or Ctrl/CursDown = End of file
  556.           h to flip between Hex/ASCII.
  557.           s or LeftAmiga/s RightAmiga/s to search.
  558.           f or LeftAmiga/f RightAmiga/f to search.
  559.           Esc or q or Keypad5 = quit.
  560.  
  561.         It runs as a separate process so you can swap screens and
  562.         use DW as normal until you don't what the text display any
  563.         more.
  564.  
  565.         The screen height and mode can be set from DWEdit.
  566.  
  567.         The title bar shows the filename and will say
  568.         "WAS POWERPACKED" if the file was crunched with powerpacker
  569.         and has been decrunched.  It will say "PARTIAL LOAD" if you
  570.         didn't have enough memory for the file so only some of
  571.         it was loaded.
  572.         By default a double click on a text file will call this
  573.         routine.
  574.  
  575.     HxType    Displays a file in hexadecimal to a window.
  576.         Use the slide gadget on right to quickly scan and use buttons
  577.         down below to move through the file or toggle between a hex
  578.         or ASCII display of the file.
  579.         Or use keyboard:-
  580.           Return or CursDown or KeyPad2 or j = NextLine.
  581.           CursUp or Keypad8 or k = PrevLine.
  582.           Space or Shift/CursDown or KeyPad3 = NextPage.
  583.           BackSpace or Shift/CursUp or KeyPad9 = PrevPage.
  584.           Keypad7 or Ctrl/CursUp = Start of file
  585.           Keypad1 or Ctrl/CursDown = End of file
  586.           h to flip between Hex/ASCII.
  587.           s or LeftAmiga/s RightAmiga/s to search.
  588.           f or LeftAmiga/f RightAmiga/f to search.
  589.           Esc or q or Keypad5 = quit.
  590.  
  591.         It runs as a separate process so you can swap screens and
  592.         use DW as normal until you don't what the text display any
  593.         more.
  594.  
  595.         The screen height and mode can be set from DWEdit.
  596.  
  597.         The title bar shows the filename and will say
  598.         "WAS POWERPACKED" if the file was crunched with powerpacker
  599.         and has been decrunched.  It will say "PARTIAL LOAD" if you
  600.         didn't have enough memory for the file so only some of
  601.         it was loaded.
  602.         By default Double click on a binary file will call this
  603.         routine.
  604.  
  605.     Instant    This performs as if you double clicked the left mouse button
  606.         on the selected files.  It will perform a relevant button
  607.         on the file if it finds one otherwise it will assume the
  608.         file is just binary and HxType it.  All these things can
  609.         be changed, see DWEdit documentation.
  610.  
  611.     Show    Shows IFF files.  Loads in the next pic while the last
  612.         is being displayed to save a lot of time.  Move mouse pointer
  613.         to edge to scroll around a picture bigger than the screen.
  614.         Use the left mouse button or press a key to go to next.
  615.         If low on memory select one file at a time to display.
  616.         By default a double click on a IFF picture file will call
  617.         this routine.  Will handle SHAM as well as some DHIRES.
  618.         Can display icons as well.  See DWEdit for more info on this.
  619.  
  620.         Keys:-
  621.         
  622.         Cursors - Move around a large bitmap at 16 pixels each press.
  623.         Shift/Cursors - Move around at a page each press.
  624.         Ctrl/Cursors - Move to extreme each press.
  625.  
  626.         Alt/Cursors - Move the view around a pixel at a time.
  627.  
  628.         l - Toggle INTERLACE.
  629.  
  630.         It runs as a separate process so you can swap screens and
  631.         use DW as normal until you don't what the text display any
  632.         more.
  633.  
  634.     PlaySS    Plays any file as a Sampled sound at 10000 samples/sec.
  635.         Will use the correct rate if the file is a 8SVX.
  636.         By default a double click on a 8SVX sound file will call
  637.         this routine.
  638.  
  639.     Search    Search files for text that you are prompted for.
  640.         The prompt has a UpperCase!=LowerCase option.
  641.         It will tell you at want offsets in the file the text is
  642.         found.
  643.  
  644.     AdIcn    Creates a project, tool, or drawer icon for any file(s)/
  645.         dirs(s) specified this is good for when you have a program
  646.         or a drawer(directory) that doesn't have icon.
  647.  
  648.  
  649.     DskOp    Starts up the internal floppy copy/format/install program.
  650.         During operations the track(0-159) and any ERROR number is
  651.         shown you can stop any operation by pressing the close gadget
  652.         of the window.  During any diskcopy "Non standard boot block"
  653.         is shown under track if disk has a not normal bootblock.
  654.         To Format a floppy:-
  655.         ----------------------
  656.             Enter diskname in text gadget (defaults to "blank")
  657.             Select destination(s) by pressing the drive buttons.
  658.             Press Format or FormatQuick.
  659.             OFS stands for the Old file system(Normal format).
  660.             FFS stands for the Fast file system.
  661.         To Install a floppy:-
  662.         --------------------
  663.             Select destination(s) by pressing the drive buttons.
  664.             Press Install button.
  665.         To copy a floppy(You must have 2 floppies or 1Meg free):-
  666.         ----------------------------------------------------------
  667.         With two or more floppies:-
  668.             Select source by pressing the left drive buttons.
  669.             Select destination(s) by pressing the drive buttons.
  670.             Press the DiskCopy button.
  671.         With one floppy:-
  672.             Insert the source in DF0:
  673.             Select DF0: as only source and destination.
  674.             Press the DiskCopy button.
  675.             Insert the destination in DF0:
  676.             Press the WriteBuf button.
  677.         To check a floppy for disk errors:-
  678.         -----------------------------------
  679.             Select source by pressing the left drive buttons.
  680.             DeSelect all destination(s).
  681.             Press DiskCopy button and see if you get a error.
  682.         Multiple copies:-
  683.         -----------------
  684.         If you select the source as one of the destinations the
  685.         complete disk will be put into ram and the WriteBuf button
  686.         will be turned on.  You can the just keep selecting the
  687.         WriteBuf button with any destination(s).
  688.  
  689.         It runs as a separate process so you can swap screens and
  690.         use DW as normal until you don't what the text display any
  691.         more.
  692.  
  693.  
  694.     VMK    My MEMORY virus detector/killer.
  695.         For a simple check to see that your memory is virus free.
  696.         Does checks of many memory locations etc that are used
  697.         by viruses.  If you get a alert use a good disk virus killer
  698.         to clear up the problem.  See the separate program VMK v1.1
  699.         for docs.
  700.  
  701.  
  702.     The following buttons require you to have a external program and/or
  703.     run in your c: or similar directory.
  704.  
  705.     Edit    Edit selected files. Requires a editor named E in a path
  706.         such as c:.
  707.         If you have no files selected E will be run without a file
  708.         name.
  709.         Pressing the right mouse button on a text file will call
  710.         a similar routine.
  711.  
  712.     NewZP    NewZAP selected files. Requires Newzap in a path such as c:.
  713.         NewZAP is a file editor © John Hodgson.
  714.         If you have no files selected NewZAP will be run without a
  715.         file name.
  716.         By default pressing the right mouse button on a binary file
  717.         will call a similar routine.
  718.  
  719.     Run    Run selected files.  You will be prompted for optional
  720.         arguments. eg if you selected the file Diskcopy you
  721.         might want to enter "DF0: to DF1:".
  722.         If you have no files selected Run will be run so you will be
  723.         requested for the program to run.
  724.         By default pressing the right mouse button on a executable
  725.         file will will call a similar routine.
  726.  
  727.     Commd    Enter commands in the Shell/CLI window then enter endcli to
  728.         return to DW or if using Kick2.0- or later click the close
  729.         gadget.
  730.  
  731.     NewSh    Does the NewShell command.  Requires all shell type files.
  732.  
  733.     EScpt    Allows you to execute any selected script files.
  734.  
  735.     LZ A    Adds file(s)/dir(s) to a LZ archive that you specify in the
  736.         prompt.
  737.  
  738.  
  739. ----------------------------------------------------------------------------
  740.     2. Options in DirWork
  741. ----------------------------------------------------------------------------
  742. Menu Options
  743.  
  744.     Move the mouse pointer up to the left side of the title bar of the
  745.     window and press the right mouse button.
  746.  
  747.  
  748.     You can select if you want the last 8 directories read to be
  749.     kept in memory so that they come up when you press the right mouse
  750.     button over the path text gadget.
  751.     This is defaulted to on.
  752.  
  753.  
  754.     You can select whether you want Fast&SmoothFloppyDirs.
  755.     Shouldn't be needed with Kick 2.0-.
  756.     Note that the DirWork FSDirs does not make use of dos buffers that
  757.     have been added using AddBuffers, but does very well with the two
  758.     commercial diskbuffering programs.
  759.     This is defaulted to off.
  760.  
  761.  
  762.     You can select if you want the directory to be updated when you
  763.     change the floppy disk in one of the drives. ie  If you have DF0:
  764.     as either you source of destination path and insert a new disk the
  765.     new directory will be automatically read in.
  766.     This is defaulted to off.
  767.  
  768.  
  769.     You can select if you want every inserted floppy disk's boot block
  770.     checked to see if it is normal.  Note some bootblocks are not normal
  771.     and are not viruses so when you insert a disk and get the requester
  772.     saying this is not a normal bootblock only install if you know that
  773.     the bootblock does not contain important information.  See the
  774.     DWEdit documentation on how to allow XCopy boot blocks.
  775.     This is defaulted to off.
  776.  
  777.  
  778.     You can select if you want VMK(The virus detector) to be run every
  779.     8 seconds.  You get a requester asking for options(see VMK docs).
  780.     This is defaulted to off.
  781.  
  782.  
  783.     You can select if you want the screen to blank after 8 minutes of
  784.     no activity by the user.  A still image on a monitor is not good for
  785.     it so this blanks the screen.  See the DWEdit documentation on
  786.     how to set the amount of time the machine must be idle.
  787.     This is defaulted to off.
  788.  
  789.  
  790.     You can select if you want Directories displayed above files.
  791.     This is defaulted to off.
  792.  
  793.  
  794.     You can select if you want .info files to be displayed.
  795.     This is defaulted to on.
  796.  
  797.  
  798.     You can select if you want the close gadget box of the window
  799.     to make dirwork sleep instead of quit.
  800.     This is defaulted to off.
  801.  
  802.  
  803.     You can select that DirWork is to have a screen of its own instead
  804.     of using the workbench screen.
  805.     This is defaulted to off.
  806.  
  807. Menu Functions
  808.  
  809.     The SAVE function will modify a DW executable to have the setup
  810.     that you currently have.  You are prompted for the name of the DW
  811.     which would most likely be C:DW.  If you have turned on the external
  812.     config option (see DWEdit documentation) the function will first
  813.     save "s:DW.config" before it prompts you to save it to the
  814.     executable.
  815.     BUTTONS/INSTANTACTIONS/MENUOPTIONS/WINDOWSIZE/WINDOWPOSITION/
  816.     POPKEYS and heaps more are all saved with this command so set up
  817.     DirWork how you like it then use this command.
  818.  
  819.  
  820.     Use external configuration editor will execute the DWEdit program
  821.     (you must have it in a valid path such as c:) and hence allow you
  822.     to change the many configuration options that you can't from DW and
  823.     change many the ones you can in a faster and easier way to
  824.     understand.  Then when you quit DWEdit you can use the SAVE function
  825.     to save all your changes to the DW executable.
  826.     Here are some of the things that can be changed using DWEdit:-
  827.         Screen Mode/Palette/Size
  828.         Window/Size/Position/Colors
  829.         AutoPointOption
  830.         MouseAcceleration/Threshold
  831.         Position Independent Button Selection Mode
  832.         ButtonsBelowOption
  833.         ScreenBlankTime
  834.         Number of Bufferred Dirs
  835.         Task Priority
  836.         XCopyBootBlocks as "standard" option
  837.         AutoActivate of Text Gadget Option
  838.         Type startup ANSI option
  839.         RMB activate option
  840.         Parent buf option
  841.         Left and right text gadget activate keys.
  842.         No Duplicates of DW option
  843.         VMK Time value
  844.         External config file Option
  845.  
  846.     Changing a button:-
  847.     You can change a button to make it do something slightly different
  848.     to something totally different.  Just press on the button then go
  849.     to the menu and select "Change last button pressed".   To change an
  850.     instant action you just do the instant action then select "Change
  851.     last button pressed".  You can also just do a binary edit of DirWork
  852.     and change them that way.  But the most user friendly was is to use
  853.     DWEdit via the "Use external configuration editor" menu item.
  854.     Here is the technical format anyway:-
  855.     "     ,       ,       "
  856.      ||||| |||\__/||
  857.      |     ||| |  |+------------Arguments for operation.
  858.      |     ||| |  |
  859.      |     ||| |  +-- Special Option for some functions
  860.      |     ||| |
  861.      |     ||| +------  Keyboard combination (qualifier/keycode)
  862.      |     |||
  863.      |     |||
  864.      |     |||+-------------- Options for certain routines.
  865.      |     ||
  866.      |     ||
  867.      |     |+--------------- What needs to be selected to operate.
  868.      |     |    F=Selected Files. D=Selected Dirs.
  869.      |     |    B=Selected Files &/or Dirs.
  870.      |     |    A=All files/dirs even if not selected. 
  871.      |     |    f=special mode that allows some files or no files
  872.      |     |    0=irrelevant
  873.      |     |
  874.      |     +--------------- Internal routine the button uses.
  875.      |               A capital letter signifies that the operation does
  876.      |               not require selected files/dirs.  A lower case
  877.      |               hence means the operation should require selected
  878.      |               files/dirs.
  879.      |      
  880.      |
  881.      +----------------------------------------  Button Name of 5 Chars
  882.                          This is the text that is displayed inside the
  883.                          button.
  884.  
  885.  
  886.  
  887.     ChangePopKey allows you to change the keys that bring DirWork
  888.     out of sleep and you can define many other keys to execute other
  889.     programs. If you are running kick2.0- the programs are also added
  890.     to the workbench tools menu.  They are always added to the DW
  891.     tools menu.
  892.     Use the DWEdit program for a more user friendly way of changing
  893.     these entries.  By default there is a couple of entries including
  894.     one to wake DW up (which must always be the first entry) and
  895.     one to start a NewShell by pressing LeftAmiga-ESC.
  896.     Here is the technical format anyway:-
  897.  
  898.          "@       ,       "
  899.            |||\__/||
  900.            ||| |  |+---------Arguments for operation.
  901.            ||| |  |           Also what appears as menu text.
  902.            ||| |  |           Must have something here for PopKey/Tools
  903.            ||| |  +------- Special Option for some functions
  904.            ||| +------  Keyboard combination (qualifier/keycode)
  905.            |||
  906.            |||
  907.            |||+-------------- Options for certain routines.
  908.            ||
  909.            ||
  910.            |+--------------- What needs to be selected to operate.
  911.            |    F=Selected Files. D=Selected Dirs.
  912.            |    B=Selected Files &/or Dirs.
  913.            |    A=All files/dirs even if not selected. 
  914.            |    f=special mode that allows some files or no files
  915.            |    0=irrelevant (This is usually the case for PopKey/Tools
  916.            |
  917.            +--------------- Internal routine the button uses.
  918.                      A capital letter signifies that the operation does
  919.                      not require selected files/dirs.  A lower case
  920.                      hence means the operation should require selected
  921.                      files/dirs.
  922.             
  923.  
  924. ----------------------------------------------------------------------------
  925.     3. Hints/tips
  926. ----------------------------------------------------------------------------
  927.  
  928.     If you are a registered user just describe what sort of button you
  929. would like configured and I will give you the button configuration text for
  930. it, if it is possible.
  931.  
  932.     To have the programs added to the tools menu under kick2.0-
  933. workbench must be loaded.  So you might have to have DW -s after loadwb and
  934. you might have to have a "wait 3" or similar command in between.
  935.  
  936.     If DW is launched from workbench it will have the paths that were
  937. added before the loadwb command so put all your path additions before that
  938. command in your startup-sequence.  If DW is started from a Shell/CLI it will
  939. have all the paths that the Shell/CLI had at that point.
  940.  
  941.     For DW's text/hex viewer to decrunch powerpacked files you must have
  942. the powerpacker.library in your libs: directory.
  943.  
  944.     Since Show, Type, & DiskOp run as separate processes you can quit
  945. DW while they are still going.  But since they are executing from DW's
  946. program memory DW will not really quit.  If there are "child" processes
  947. still running DW goes into a delayed quit until the processes have been
  948. exited from then it really quits.  But if you press the wake up keys or
  949. similar or have no duplicates option set and start another DW while it is
  950. in this delayed quit mode, it will start up and forget that you ever said
  951. quit.  It forgives you for you mental lapse in actually wanting to quit DW !
  952.  
  953.     DW makes its screen public for kickstart 2.0- so you can open other
  954. windows such as consoles on it.  The name of DW's screen is "DW Screen0"
  955. where 0 increases as you run more DW's.
  956.  
  957.     You can stop a multiple file/dirs function (like copying more than
  958. one file or deleting files and dirs) by pressing the left mouse button over
  959. the error display area.  This is the area where the diskname and bytes free
  960. is usually displayed.
  961.  
  962.     If you want to crunch DirWork use PowerPacker V3 or later as it
  963. does the correct things, other crunchers may cause DW to crash when
  964. launched from the Shell/CLI.  If you are using DW crunched you probably
  965. will use the external config option (selectable with DWEdit).  To do this
  966. go to DWEdit before you crunch DW and select the external config file
  967. option then quit(using quit & Save button) DWEdit and SAVE config to
  968. DirWork executable.  Then you can crunch DirWork and the config will always
  969. be fetched/stored in "s:DW.config" file.
  970.  
  971. Bye,
  972.     Chris Hames (Available for Amiga programming work)
  973.  
  974.